Helm 차트 관리 - nginx 버전 업그레이드

Helm은 Kubernetes 애플리케이션의 패키징, 배포, 관리를 위한 패키지 관리자입니다. 복잡한 애플리케이션을 쉽게 정의하고 설치하며 업그레이드할 수 있게 해줍니다. Helm은 "Kubernetes의 apt/yum/homebrew"라고 볼 수 있습니다.

Helm의 주요 이점

단순화된 배포: 복잡한 애플리케이션을 하나의 명령으로 설치
일관성: 환경 간 동일한 구성 유지
버전 관리: 애플리케이션 버전 관리 및 롤백 기능
재사용성: 미리 패키징된 차트 활용 가능
공유: 커뮤니티와 조직 내에서 구성 공유

핵심 개념

Chart: Kubernetes 리소스를 정의하는 파일의 집합 (예: nginx 차트)
- 템플릿 파일, 기본값, 메타데이터 등을 포함
- Kubernetes YAML 파일의 패키지화된 버전
Repository: 차트를 저장하고 공유하는 저장소 (예: bitnami 레포지토리)
- 공개 또는 비공개로 운영 가능
- 여러 버전의 차트를 저장
Release: 클러스터에 배포된 차트의 인스턴스 (예: my-nginx)
- 하나의 차트로 여러 개의 릴리스 생성 가능
- 각 릴리스는 독립적으로 관리됨

자주 사용하는 명령어

# 저장소 추가
helm repo add bitnami https://charts.bitnami.com/bitnami

# 저장소 정보 업데이트
helm repo update

# 릴리스 목록 확인
helm list -n <namespace>

# 차트 설치
helm install <release-name> <chart-name> -n <namespace>

# 릴리스 업그레이드
helm upgrade <release-name> <chart-name> --version <version> -n <namespace>

2026-10 갱신

현재 Helm 최신 버전은 v4.3(Helm 4)입니다. 이 문서의 기본 명령(repo add/repo update/list/install/upgrade/search repo)은 Helm 4에서도 동일하게 사용합니다. <chart-name>은 bitnami/nginx처럼 <저장소 이름>/<차트 이름> 형식으로 지정합니다.

2026-10 갱신 — Bitnami 카탈로그 변경

Bitnami는 2025년 8~9월 무료 카탈로그 정책을 변경했습니다. 무료 이미지는 개발용 latest 태그 중심으로 제한되고, 기존 버전 태그 이미지는 bitnamilegacy 저장소로 이동되어 더 이상 업데이트(보안 패치 포함)되지 않습니다.
아래 실습의 bitnami/nginx 특정 버전 차트는 이미지 pull 실패 또는 미패치 이미지 사용 문제가 생길 수 있으므로, 실습용으로만 참고하고 운영 환경에서는 공식 nginx 이미지·다른 차트 저장소 사용을 검토합니다.

nginx 버전 업그레이드 실습

현재 설치된 nginx 확인

$ helm list -n kk-ns
NAME       NAMESPACE  REVISION  UPDATED                                STATUS    CHART         APP VERSION
kk-mock1   kk-ns      1         2025-03-10 15:20:33.472829 +0900 KST  deployed  nginx-18.1.14 1.25.3

사용 가능한 nginx 차트 버전 확인

$ helm search repo nginx --versions
NAME            VERSION   APP VERSION  DESCRIPTION
bitnami/nginx   18.1.15   1.25.4       NGINX Open Source is a web server...
bitnami/nginx   18.1.14   1.25.3       NGINX Open Source is a web server...
...

nginx 차트 업그레이드

$ helm upgrade kk-mock1 bitnami/nginx --version 18.1.15 -n kk-ns
Release "kk-mock1" has been upgraded. Happy Helming!
NAME: kk-mock1
LAST DEPLOYED: Tue Mar 11 10:25:42 2025
NAMESPACE: kk-ns
STATUS: deployed
REVISION: 2
...

업그레이드 확인

$ helm ls -n kk-ns
NAME       NAMESPACE  REVISION  UPDATED                                STATUS    CHART         APP VERSION
kk-mock1   kk-ns      2         2025-03-11 10:25:42.683921 +0900 KST  deployed  nginx-18.1.15 1.25.4

자주 사용하는 파라미터